home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / catn / tkwait.n < prev    next >
Text File  |  1994-09-20  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. tkwait(n)                  Tk Commands
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      tkwait - Wait for variable to change or window  to  be  des-
  12.      troyed
  13.  
  14. SYNOPSIS
  15.      tkwait variable _n_a_m_e
  16.      tkwait visibility _n_a_m_e                                        |
  17.      tkwait window _n_a_m_e
  18. _________________________________________________________________
  19.  
  20.  
  21. DESCRIPTION
  22.      The tkwait command waits for one of several things  to  hap-
  23.      pen,  then it returns without taking any other actions.  The
  24.      return value is always an empty string.  If the first  argu-
  25.      ment is variable (or any abbreviation of it) then the second
  26.      argument is the name of a global variable  and  the  command
  27.      waits  for that variable to be modified.  If the first argu-
  28.      ment is visibility (or any  abbreviation  of  it)  then  the  |
  29.      second  argument is the name of a window and the tkwait com-  |
  30.      mand waits for a change in its visibility  state  (as  indi-  |
  31.      cated  by  the  arrival  of a VisibilityNotify event).  This  |
  32.      form is typically used to wait for a newly-created window to  |
  33.      appear  on  the  screen  before  taking some action.  If the
  34.      first argument is window (or any abbreviation  of  it)  then
  35.      the  second  argument is the name of a window and the tkwait
  36.      command waits for that window to be destroyed.  This form is
  37.      typically used to wait for a user to finish interacting with
  38.      a dialog box before using the result of that interaction.
  39.  
  40.      While the tkwait command is waiting it processes  events  in
  41.      the  normal  fashion,  so  the  application will continue to
  42.      respond to user interactions.
  43.  
  44.  
  45. KEYWORDS
  46.      variable, visibility, wait, window
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Tk                                                              1
  64.  
  65.  
  66.  
  67.